home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Cream of the Crop 25
/
Cream of the Crop 25.iso
/
windows
/
winxs32a.zip
/
README.TXT
< prev
next >
Wrap
Text File
|
1997-02-12
|
19KB
|
407 lines
WinXs Version 2.0
Copyright (C) 1997 Mick Meaden
All Rights Reserved
INTRODUCTION
WinXs for Windows is a shareware program that provides
UNIX-like tool functionality under Windows 3.1, Windows for
Workgroups, Windows 95 and Windows NT. To run WinXs, you
will need a 386-based PC (or later), at least 4mb of main
memory and approximately 2.0mb or 3.5mb of disk space to
install the software (see below).
WinXs comes in 16-bit and 32-bit versions. The 16-bit ver-
sion will run on Windows 3.1, Windows for Workgroups or Win-
dows 95; the 32-bit version will only run on Windows 95 and
Windows NT. The two versions are functionally identical,
albeit that for integration with Explorer, or to take advan-
tage of long filenames and pre-emptive scheduling on Windows
95/NT, you will need to run the 32-bit version. This ver-
sion also requires 3.5 mb of disk space for installation, as
opposed to the 2.0mb required for the 16-bit version.
CONTENTS
Features of this version of WinXs include:
i. Cat for Windows. Concatenates one or more files and
appends them to a named output file, which is created
if it does not already exist.
ii. Col for Windows. Filters reverse line-feeds and vari-
ous other control characters. Optionally, this filter
can also be used to remove backspace sequences or to
convert spaces to tabs.
iii. Compress and Uncompress. Windows version of the UNIX
compress(1) and uncompress(1) commands, which are use-
ful when downloading files from the Internet or when
transferring large files to and from UNIX systems.
iv. Csplit. Splits a text file based on context. Sec-
tions of a named input file can be written to dif-
ferent output files or skipped based on an argument
list, which consists of a series of regular expres-
sions and line numbers that indicate the end of each
input section. Any lines left in the input file after
all arguments have been matched are written out as a
single section to the last output file.
v. Dos2unix and Unix2dos. Filters for converting between
DOS and UNIX text file formats; that is, CR-LF (DOS)
and LF (UNIX).
vi. Du for Windows. A Windows implementation of the UNIX
du(1) command, which recursively lists the number of
blocks allocated to files and directories.
vii. Expand for Windows. Performs the opposite function of
col(1) and expands tabs to spaces.
viii. File Compare. A set of programs that perform various
file comparisons, including binary comparisons based
on the UNIX cmp(1) program, directory comparisons
based on dircmp(1), and differential text file com-
parisons based on diff(1).
ix. File for Windows. This program attempts to determine
the contents of a file or files by examination of the
Windows registration database, a table of magic
numbers uniquely identifying file types, and finally
the contents of the file itself.
x. Fmt for Windows. A simple text processing utility for
performing modest tasks such as formatting mail mes-
sages. Text can be formatted using block, indented,
crown or centered paragraphs, optionally with left and
right text justification.
xi. Fold for Windows. Folds lines from its input files,
breaking the lines to have a maximum column width
(after tab and backspace processing) or a maximum
number of bytes. Optionally, lines can be broken at
the last blank character within the specified column
or byte width.
xii. Grep for Windows. A pattern searching program that
scans one or more text files for a specified character
sequence. Grep uses basic regular expression pattern
matching, as defined in X/Open Portability Guide Issue
4.
xiii. Grex for Windows. Is a simple stream editor that sup-
ports various ed(1)-like editing commands. These
include text matching and substitution, text deletion,
line deletion, and multi-line text insertion.
xiv. Gzip and Gunzip. Provides a Windows interface to GNU
gzip(1), which is a separate DOS program that can be
obtained free of charge under the terms and conditions
of the GNU software license (see associated help file
for further details).
xv. Hd for Windows. A file viewer that will display any
type and size of file in hexadecimal format. Hd sup-
ports the same scrolling, search and text marking com-
mands as More. It also supports printing and print
previewing.
xvi. Head and Tail. These tools display the first, middle
or last part of one or more text files. The amount of
text displayed (in numbers of lines) is specified via
the associated dialog.
xvii. More for Windows. A file viewer that supports more(1)
functionality and file movement commands. This is a
full featured Windows MDI (multi-document interface)
application, with print and print previewing using
pr(1), basic regular expression searching, text mark-
ing, configurable display and printer fonts, escapes
to your favourite editor, rendering with or without
line numbers, text or hexadecimal display, etc.. More
supports File Manager drag and drop and will display
files of any size, depending on virtual store availa-
bility.
xviii. Nl for Windows. A filter that allows line numbers to
be added to one or more text files. Line numbers are
added on the left under the control of various
options, which permit line numbers to be left or right
justified and padded with either spaces or zeros.
Optionally, all input lines can be numbered, or
numbering can be limited to non-blank lines only.
xix. Pax for Windows. Provides a Windows interface for the
creation, reading and writing of cpio, ustar or tar
portable archives. The archive formats supported by
this utility are fully compatible with the extended
cpio and extended ustar archive formats defined by
X/Open and POSIX. Pax can be used for local archiv-
ing, or it can be used for information interchange
with UNIX systems.
xx. Sed for Windows. A stream editor that applies an
editing script to one or more input text files,
overwriting the input files with the results or con-
catenating the output to a single named output file.
The command syntax supported by this tool is fully
compatible with the stream editor command syntax
defined in ISO/IEC 9945-2: 1993, Information
Technology - Portable Operating System Interface
(POSIX) - Part 2: Shell and Utilities.
xxi. Sort for Windows. Sorts and/or merges one or more
text files, either numerically or lexicographically.
Options allow the sort order to be reversed, diction-
ary sorting, case folding, blanks or non-printing
characters to be ignored, and duplicate lines to be
omitted from the output.
xxii. Split for Windows. A Windows version of the UNIX
split(1) command, which breaks a file up into a speci-
fied multiple of line, byte, kilobyte or megabyte
pieces. This version also provides an Unsplit facil-
ity for combining output files generated by a previous
call to Split back into a single, large file.
xxiii. Strings for Windows. This utility is commonly used
on UNIX systems to search object files for copyright
statements, error messages, etc.. This version will
scan files of any size and content, and will option-
ally display file offsets of located strings.
xxiv. Tr for Windows. Substitutes, deletes or squeezes
characters from its input. This is a general purpose
filter that can be used for such things as converting
the case of characters, deleting control characters,
breaking files up into word lists, reducing multi-
character sequences to single characters, etc..
xxv. Uuencode and Uudecode. Windows versions of the UNIX
commands of the same name. Useful when downloading
stuff from the Internet, or when using UNIX mail.
xxvi. Wc for Windows. A Windows version of the UNIX wc(1)
command, which counts the number of lines, words and
bytes in one or more text files.
xxvii. Winxsdll.dll. This DLL adds an extra menu to the
Windows File Manager menu bar, allowing the above
WinXs programs to be initiated directly from File
Manager (see below for details).
xxviii. WinXs Shell (32-bit version only). This is
activated from the Folders context menu within
Explorer and provides A UNIX-like directory display,
plus easy access to any of the WinXs tools. The WinXs
shell is also available from the context menu associ-
ated with the Start button on Taskbar.
The WinXs utilities can be accessed directly from File
Manager, or from Explorer and the Taskbar (32-bit version
only). To use More as the default text file viewer or text
file print program on your system, run WinXs setup and check
the appropriate configuration options (see setup help for
further details).
In addition, this version if WinXs also includes the follow-
ing command line tools: cat, cmp, col, compress, csplit, df,
diff, dircmp, dos2unix, du, expand, file, find, fmt, fold,
grep, head, ls, man, nl, sed, sort, split, strings, tail,
tr, uudecode, uuencode, unix2dos, wc. These can be used
either in batch files or from the Command prompt.
All WinXs commands line tools support an option -h, which
causes the tool to display a brief synopsis and usage line.
For more detailed information use the "man" command, which
displays a reference manual page for the named command or
commands (e.g., man man). Use "man -k -" to display a com-
plete list of manual reference pages.
INSTALLING WINXS
To install WinXs on your system, do the following:
1. Create a directory to hold the installation (e.g.,
c:\winxs).
2. Unzip the distribution file (winxs16.zip or
winxs32.zip) into the above directory. Note that the
directory structure of the ZIP file should be
preserved. If you are using PKUNZIP, this can be done
by using the -d option as follows:
pkunzip -d winxs32.zip
If you are using WINZIP, ensure the Use Folder Names
option is checked in the Extract dialog box. Other
ZIP tools should provide a similar facility.
3. Run the WinXs setup program (SETUP.EXE), which is
located in your installation directory. This will add
Win&Xs to the File Manager menu bar, add the WinXs
shell to Explorer context menus (32-bit version only),
associate a text editor for use from File Manager and
the WinXs shell, and allow configuration of other
options present in this version of the product.
SETUP.EXE can be re-run at any time to change these
options.
NOTE. If File Manager is running when setup is exe-
cuted, it must be stopped and restarted before changes
affecting File Manager (e.g., adding WinXs to the menu
bar) can take effect.
If you prefer, you can try out the WinXs tools before
integrating the product with File Manager or Explorer, and
before making any changes to other system files. Create a
WinXs directory, as indicated above, and unzip the distribu-
tion file. DO NOT RUN THE SETUP PROGRAM. Select the WinXs
directory in File Manager or Explorer, and simply double-
click any of the .EXE files to try out the tools. The first
screen displayed by each tool will contain a Help button;
click this to display the associated manual page.
The following table indicates which tools are located in
which .EXE files:
______________________________________________________
| .EXE File | Tool |
|______________|______________________________________|
| | |
| DOSCONV.EXE | dos2unix(1), unix2dos(1). |
| | uuencode(1), uudecode(1), |
| | compress(1), uncompress(1), |
| | gzip(1), gunzip(1). |
| | |
| FILTERS.EXE | cat(1), col(1), expand(1), |
| | fold(1), fmt(1), grex(1), |
| | nl(1), sort(1), tr(1). |
| | |
| GENUTS.EXE | cmp(1), csplit(1), diff(1), |
| | du(1), file(1), grep(1), |
| | head(1), sed(1), split(1), |
| | strings(1), tail(1), wc(1). |
| | |
| HD.EXE | hd(1). |
| | |
| MORE.EXE | more(1), pr(1). |
| | |
| WINPAX.EXE | cpio(1), pax(1), tar(1). |
| | |
| WINXSSH.EXE | WinXs Shell (32-bit version only). |
|______________|______________________________________|
The SETUP.EXE program can be run at any stage to complete
the installation process, or not at all.
CONFIGURING THE COMMAND LINE TOOLS
The WinXs command line tools are made available by adding
the appropriate WinXs directory to your environment search
path. This is done by adding or modifing a call to the PATH
command in the autoexec.bat file. For example,
PATH c:\winxs\bin;c:\windows;c:\dos
This identifies three directories that will be searched
automatically when entering a command at the command prompt;
namely, "c:\winxs\bin", "c:\windows", and "c:\dos". The
exact nature of this command will vary from system to sys-
tem, so you should check your current setting before making
any changes.
Note that "winxs" in the above example is the name of the
directory where you installed WinXs. The command line tools
are located in the "bin" subdirectory below this directory.
UPGRADING A PREVIOUS VERSION OF WINXS
Because this release updates the WinXs DLL, it is important
to ensure that File Manager IS NOT running when you upgrade.
Copy the ZIP file to your WinXs directory, unzip using pkun-
zip, WinZip (or equivalent) and restart File Manager. Re-
run the WinXs setup program if you want to add the WinXs
shell to Explorer context menus, or if you want to change
any of the configuration options.
UNINSTALLATION
The uninstall process has been made as clean and simple as
possible. Re-run the setup program and click the Uninstall
button; this will undo all changes made to system files and
remove any WinXs .ini files from your Windows directory. To
complete the uninstall process, manually delete the WinXs
installation directory and all its contents.
WINDOWS 95/NT
This version of WinXs can be installed on Windows 95 and
Windows NT as indicated above. Optionally, the setup pro-
gram will add the WinXs tools to the File Manager menu bar,
and the WinXs Shell to Folder and Document context menus in
Explorer (32-bit version only). It is also recommended that
the default text file viewer in the Windows Registry is
changed to use the more.exe tool supplied with this package
(see setup help for details).
REGISTRATION
WinXs is a shareware program. It can be used for a period
of up to 30 days free of charge, after which it must be
removed from your system or a license fee of 18 dollars U.S.
(12 pounds Sterling) must be paid. Benefits of registration
include:
+ Free product upgrades.
+ A key code which unlocks the following additional func-
tionality:
- Options can be saved from more. This includes
font selections, tab settings, editor preference,
and window position. The last of these, window
position, also affects the hd utility.
- Utilities that accept multiple input file names or
patterns work correctly without displaying a nag
screen, including cat, col, compress, dos2unix,
expand, fmt, fold, grep, grex, gzip, gunzip, nl,
pax, sed, strings, tail, tr, uncompress, unix2dos,
wc and winxssh.
+ A copy of the WinXs User Reference Manual will be sent
by email. This document is distributed in Microsoft
Word format and is the definitive guide to using the
various WinXs utilities.
WinXs can be registered in a number of ways, the quickest
and most convenient of which is via the CompuServe Shareware
Registration Database (GO SWREG). The registration ID for
WinXs is 7400. Alternatively, it can be registered by using
the order form in file REGISTER.TXT.
Your registration number and a copy of the WinXs User Refer-
ence Manual will be emailed to you immediately on receipt of
registration (if possible), or will be sent to you by return
of post.
As a registered user of WinXs, you will be notified about
future product updates as soon as they become avail-
able. You can download these free of any additional software
charges.
REPORTING PROBLEMS
If you have any problems with WinXs, or if you have any
queries or comments, please send email to the following
address:
100345.2641@compuserve.com
If you do not have access to email, then write to the
address given in the file REGISTER.TXT. All support issues
and queries will be dealt with as quickly as possible.